home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / share / doc / python-parted / README < prev   
Encoding:
Text File  |  2009-01-27  |  2.6 KB  |  61 lines
  1. pyparted
  2. Python bindings for libparted
  3. -----------------------------
  4.  
  5. OVERVIEW
  6.  
  7. pyparted is a set of native Python bindings for libparted.  libparted is the
  8. library portion of the GNU parted project.  With pyparted, you can write
  9. applications that interact with disk partition tables and filesystems.
  10.  
  11. The Python bindings are implemented in two layers.  Since libparted itself
  12. is written in C without any real implementation of objects, a simple 1:1
  13. mapping of externally accessible libparted functions was written.  This
  14. mapping is provided in the _ped Python module.  You can use that module if
  15. you want to, but it's really just meant for the larger parted module.
  16.  
  17.     _ped       libparted Python bindings, direct 1:1: function mapping
  18.     parted     Native Python code building on _ped, complete with classes,
  19.                exceptions, and advanced functionality.
  20.  
  21. The _ped module is written and maintained by hand.  I chose to do this
  22. rather than rely on a tool like SWIG or Pyrex for several reasons.  Mostly
  23. because I was the GNU parted maintainer, but also because libparted is sort
  24. of complex.  It's a lowlevel system tool and I found it doesn't translate
  25. well in the tools I tried.  This is nothing against those tools, I just
  26. don't think libparted is ideal to go through SWIG or Pyrex.  By writing my
  27. own bindings, I can also find bugs in libparted that I may have overlooked
  28. before.  See the WHY file for more explanation as to why I wrote the
  29. bindings by hand.
  30.  
  31.  
  32. HISTORY
  33.  
  34. pyparted started life at Red Hat and continues there today.  The main reason
  35. for writing it was to let anaconda (the Red Hat installation program, now
  36. used by RHEL and Fedora and many other distributions) interact with
  37. libparted.  Anaconda is written in Python, so native bindings made sense.
  38.  
  39. pyparted went through many rewrites, but the end result was always the same.
  40. And incomplete API via Python with just enough provided for anaconda to do
  41. its job.
  42.  
  43. The latest iteration of pyparted aims to be a complete API mapping and even
  44. provide a nice set of classes so that people might want to integrate it in
  45. to other installers or even write other applications (maybe a Python based
  46. alternative to parted(8) or fdisk(8)).
  47.  
  48.  
  49. QUESTIONS
  50.  
  51. If you are reporting a pyparted failure in Fedora, it's most useful if
  52. you file a bug at http://bugzilla.redhat.com/ against the appropriate
  53. Fedora release you are using.
  54.  
  55. Alternatively, you can file bugs directly on the project page:
  56. http://fedorahosted.org/pyparted/
  57.  
  58. If you just have questions about pyparted, you can email us directly
  59. using the contact information in the AUTHORS file.  We will do our best
  60. to help you.
  61.